home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 6 / Night Owl's Shareware - PDSI-006 - Night Owl Corp (1990).iso / 028a / rv243.zip / RV.DOC < prev    next >
Text File  |  1992-01-11  |  9KB  |  213 lines
  1. RV-RView, Version 2.43                                  11-Jan-92
  2.  
  3.  
  4. Directory lister & utility for ARC ARJ LZH LZS PAK ZIP ZOO.  Displays sorted
  5. member names by default.  Converts self-extracting (SFX) archives to normal
  6. archives.  Resets archive dates/times to match newest member.  Strips extra
  7. bytes from ends of ARJ/LZH/ZIP files.  Strips/attaches ZIP file comments.
  8. Sorts ZIP/LZH files on disk.  New:  Fixes bug when displaying compressed
  9. file attributes.
  10.  
  11. Contents:
  12. =========
  13. Disclaimer
  14. Purpose
  15. Displayed data
  16. Syntax
  17. Switches
  18. Keyboard commands
  19. Configuration
  20.  
  21. Disclaimer:
  22. ===========
  23. RView and this documentation are offered as is.  The user bears the entire
  24. risk of this software not performing as expected.
  25.  
  26. Purpose:
  27. ========
  28. To provide a single, stand-alone program capable of listing directories of
  29. several archive formats.  Filename extensions are ignored in determining
  30. archive types.
  31.  
  32. This utility also contains various features not conveniently provided
  33. elsewhere at the time of their inclusion.
  34.  
  35. RView is a free program.
  36.  
  37. Displayed data:
  38. ===============
  39. Sample of output redirected to file:
  40.  
  41. --
  42.  
  43. RV-RView, Version 2.43, 11-Jan-92, rtk
  44.  
  45. ZIP SFX: PKZ193A.EXE
  46.  
  47. Name           Length Method       Size CF%   Date     Time   CRC      Attr Hdr
  48. ------------ -------- -------- -------- --- -------- -------- -------- ---- ---
  49. ALPHA193.DOC     9299 DeflateX     3825  59 10-15-91 19:30:00 7FBF4B0D a--w 2.0
  50. APPNOTE .TXT    32227 DeflateX     9980  70 10-15-91 19:30:00 E7A0C28F a--w 2.0
  51. BENCH   .DOC     2449 DeflateX      596  76 10-15-91 19:30:00 23767266 a--w 2.0
  52. BUGREP  .DOC     2275 DeflateX      999  57 10-15-91 19:30:00 980860FA a--w 2.0
  53. CRC     .DOC     1547 DeflateX      781  50 10-15-91 19:30:00 F65814D8 a--w 2.0
  54. PKUNZIP .EXE    19411 Stored      19411   0 10-15-91 19:30:00 43C890D7 a--w 2.0
  55. PKZIP   .EXE    24411 Stored      24411   0 10-15-91 19:30:00 310BCD85 a--w 2.0
  56. ------------ -------- -------- -------- --- -------- -------- -------- ---- ---
  57.        7        91619 ZIP SFX     60003  35 10-15-91 19:30:00
  58.  
  59.   102400 bytes needed to extract to C:, enough disk space
  60.    13297 bytes in SFX header
  61.  
  62.        1 file searched
  63.        1 archive found
  64.  
  65. --
  66.  
  67. The type of archive is displayed before listing each archive.  For
  68. self-extracting archives, the letters "SFX" follow the name of the base
  69. archive type.  The program further distinguishes between small- and
  70. large-model LZH SFX archives and shows which ZIP SFX's are of the "Mini"
  71. type.
  72.  
  73. For ZIP 2.0-type archives, the three different variations for "deflating"
  74. are reported as "Deflate", "DeflateX" and "DeflateF" for Normal, maXimal and
  75. Fast compression, respectively.
  76.  
  77. Compression factors ("CF") used by RView may be expressed as follows:
  78.  
  79.              100 - ( CompressedSize / OriginalSize * 100 )
  80.  
  81. Thus, the larger the number, the more disk space saved by compressing.
  82.  
  83. The date and time indicated on the "totals" line represent the date and time
  84. of the most recently created or modified member of each archive.  These are
  85. the values used by /R in resetting the archive date and time.
  86.  
  87. RView displays the total number of bytes required to contain the listed
  88. members if extracted to a selected drive.  If no drive is selected, the
  89. drive containing the archive being listed is used.  In making this
  90. computation, RView takes actual disk cluster sizes into account.
  91.  
  92. Syntax:
  93. =======
  94. Usage:  RV [switches] archive_name [d:] [member_name...]
  95.  
  96. Switches (optional) may appear in almost any position on the command line.
  97. '-' may be substituted for '/' wherever DOS allows.
  98.  
  99. In the above syntax, "archive_name" may optionally include a drive and/or
  100. path designation.  An archive name specified without an extension will
  101. result in a search for all extensions.  Thus typing "RV filename" is
  102. equivalent to "RV filename.*".  Also, "RV *" is equivalent to "RV *.*".
  103.  
  104. An optional drive may be included immediately after the archive name to
  105. check for extraction sizes to the indicated drive.
  106.  
  107. Example:        RV backup.lzh a:
  108.  
  109. Result:         Causes RView to compute extraction sizes for drive A:.
  110.  
  111. File specifications following the archive name will limit the listing to
  112. only those members matching any of these specifications.
  113.  
  114. Example:        RV source.zip *.h *.c
  115.  
  116. Result:         Causes RView to list only C header and source files
  117.                 contained within SOURCE.ZIP.
  118.                 
  119. Switches:
  120. =========
  121. /W        List members in Wide display format.  Displays up to five names
  122.           per line.
  123.  
  124. /B        Brief filenames, without path.  Use this switch to suppress the
  125.           display of full pathnames, i.e. only the filename.ext parts of
  126.           full pathnames will be shown.
  127.  
  128. /P        Pause display after each screenful.  After pausing, pressing
  129.           almost any key causes another screenful to be displayed.
  130.  
  131. /N        List members in Natural order.  Member names are displayed in the
  132.           order actually stored on disk.
  133.  
  134. /R        Reset date and time of archive.  The date and time used will be
  135.           those of the most recently created or modified member of each
  136.           archive.
  137.  
  138. /D        Sort LZH and ZIP files on Disk.  The local headers (and central
  139.           directory headers for ZIP files) of unsorted archives are written
  140.           back to disk in sorted order.  Nothing is done for already-sorted
  141.           archives.  Sorting to disk is available so that LZH and ZIP files
  142.           will be displayed in sorted order by listers that don't do
  143.           in-memory sorts.  Also, disk-sorting is useful for LZH files when
  144.           telops ('!' files) are used.
  145.  
  146. /L        ReLax checking.  If RView's default mode isn't able to list an
  147.           archive, this option may allow it to do so.  Use this option with
  148.           care, especially in conjunction with other options which actually
  149.           modify archives.
  150.  
  151. /U[path]  Un-SFX self-extracting archive.  Converts self-extracting (SFX)
  152.           archives to normal archives.  A new file will be created with the
  153.           same name as the SFX file but with the appropriate extension
  154.           (".ARC", ".LZH", etc.).  The normal archive is written to the
  155.           current directory by default.  "/U" followed immediately by a
  156.           valid path (no intervening spaces) allows writing to the
  157.           specified target drive/directory.
  158.  
  159. /C[file]  Strip/attach ZIP file Comment.  Strips ZIP file comments from ZIP
  160.           files.  If a valid filename immediately follows "/C" (no
  161.           intervening spaces), then comments contained in that file will be
  162.           attached to any ZIP files matching "archive_name".
  163.  
  164. /X        Strip eXtra bytes from end of archive.  XMODEM-type file transfer
  165.           protocols often pad transferred files with added bytes.  This
  166.           will truncate ARJ, LZH and ZIP archives to reflect their "true"
  167.           sizes.
  168.  
  169. /A        Strip All - same as /U /C /X.
  170.  
  171. /I        Ignore previous switches.  This option was added by user request
  172.           to provide some means of overriding the defaults specified in
  173.           RV.CFG.  Using this switch causes all previous switches, both in
  174.           RV.CFG and to the left on the command line to be "forgotten",
  175.           thus temporarily resetting RV back to "factory defaults".
  176.  
  177. Keyboard commands:
  178. ==================
  179. By user request, beginning with Version 2.34, the single-key,
  180. program-pausing feature has been added back.  To use this, while RView is
  181. displaying an archive, pressing <Esc> will terminate execution.  Almost any
  182. other key will pause the program.  After pausing, pressing <Esc> will
  183. terminate execution.  Again, almost any other key will resume execution.
  184.  
  185. Configuration:
  186. ==============
  187. A free-form configuration file containing user-selected default switches may
  188. be created or edited with any editor or word processor which can write pure
  189. ASCII text files.  This file should be named "RV.CFG".  Only the first 1024
  190. characters of RV.CFG are significant.  This file is "free-form" in the sense
  191. that switches may be freely interspersed with comments.  In creating or
  192. modifying this file, avoid the use of the '/' and '-' characters in
  193. comments, as these may be interpreted as (sometimes invalid) switches.
  194.  
  195. RView will search for RV.CFG first in the current directory.  If it is not
  196. found there, then each directory in the PATH is searched.  Incompatible
  197. switches used on the command line will override switches included in RV.CFG.
  198. Switches are evaluated from left to right on the command line.
  199.  
  200. A sample RV.CFG file is included in the distribution archive for RView.
  201. Please note that this is only a *sample* .CFG file.  After extracting the
  202. contents of the distribution archive, RV.CFG may be safely deleted if
  203. RView's defaults are satisfactory.
  204.  
  205. --
  206.  
  207.                 Raymond T. Kaya
  208.                 P. O. Box 1436
  209.                 Honolulu, HI  96806
  210.  
  211.                 CompuServe:  71230,2500
  212.                 GEnie     :  R.KAYA1
  213.